home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / preps111.zip / PREPS.DOC < prev    next >
Text File  |  1993-01-08  |  13KB  |  318 lines
  1.  
  2.  
  3.  
  4.      PREPS V1.11 Copyright (c) 1992-1993 Copy Con Incorporated       Page 1
  5.  
  6.  
  7.      DESCRIPTION
  8.      -----------
  9.      PREPS is a command-line utility which allows you to send ANY commands
  10.      to your Epson compatible printer. PREPS has over 70 built-in commands,
  11.      and it also gives you the ability to create and store your own, using
  12.      binary, octal, decimal, hex, and text codes. Commands can be stacked,
  13.      and they can be sent to any device or file.
  14.  
  15.  
  16.      REQUIREMENTS
  17.      ------------
  18.      PREPS will run on any PC compatible running DOS 3.0 or better, with an
  19.      Epson compatible printer (which, while not actually required, would
  20.      make the program a bit more useful... ;^). If you wish to add new
  21.      commands, an ASCII text editor will also be needed.
  22.  
  23.  
  24.      DISCLAIMER
  25.      ----------
  26.      PREPS is distributed on an "AS IS" basis without warranty, expressed
  27.      or implied. Considerable testing effort has been expended, but the
  28.      user is advised to check the program's suitability before relying on
  29.      it. The user assumes full risk as to the results of using this
  30.      program. In no event shall the author be liable for any incidental or
  31.      consequential damages arising from the use, or inability to use this
  32.      program.
  33.  
  34.      All product names mentioned in this document are either Copyright or
  35.      Trademark of respective owners.
  36.  
  37.  
  38.      REGISTRATION
  39.      ------------
  40.      PREPS is freely distributable and fully functional, and may be used
  41.      for a 30-day trial period. If you plan to continue using PREPS, you
  42.      are obligated to pay the modest registration fee of $10, which
  43.      entitles you to unlimited free upgrades (to be distributed through
  44.      standard Shareware channels). Upgrades obtained directly ($5 shipping)
  45.      will have an individual serial number and no registration reminders.
  46.  
  47.      All registration information is contained in the PREPS.REG file. If
  48.      that file is missing, register by sending your name, address, and a
  49.      check or money order for $10 ($15 for the registered version) in US
  50.      dollars to:
  51.  
  52.         Copy Con Incorporated
  53.         PO Box 23255
  54.         Baltimore MD 21203-5255
  55.  
  56.      MD residents add 5% sales tax. If ordering the registered version,
  57.      please specify 3.5" or 5.25" diskette.
  58.  
  59.      Thank you for supporting Shareware.
  60.  
  61.  
  62.  
  63.      PREPS V1.11 Copyright (c) 1992-1993 Copy Con Incorporated       Page 2
  64.  
  65.  
  66.      INSTALLATION
  67.      ------------
  68.      To install, copy both PREPS.EXE and PREPS.DAT into your path. To add
  69.      new commands to PREPS, you will also need an ASCII text editor to edit
  70.      PREPS.DAT (see CREATING NEW COMMANDS).
  71.  
  72.  
  73.      OPERATION
  74.      ---------
  75.      PREPS is activated from the command line, using the format
  76.  
  77.         PREPS [/device] command[-] [command[-]]...
  78.  
  79.      By default, PREPS sends commands to the LPT1 device; to specify
  80.      another, use the /device switch, specifying a valid device or
  81.      filename; for example,
  82.  
  83.         PREPS /lpt2 reset
  84.  
  85.      sends the reset command to the device connected to LPT2.
  86.  
  87.      PREPS has over 70 built-in commands, and they can be sent individually
  88.      or combined with other commands. A command directly followed by a -
  89.      (minus sign) disables the command, where applicable; for example,
  90.  
  91.         PREPS italic underline-
  92.  
  93.      enables italics and disables underlining.
  94.  
  95.      Commands do not need to be typed out in their entirety; only as much
  96.      of the command that distinguishes it from other commands is needed;
  97.      for example, when sending subscript and superscript commands,
  98.      "PREPS su" would send subscript because it alphabetically precedes
  99.      superscript; "PREPS sup" would send superscript. When using PREPS
  100.      inside batch files, it is a good idea to use the full command, as
  101.      future versions of PREPS may have more built-in commands that may be
  102.      similar to existing commands.
  103.  
  104.  
  105.      BUILT-IN COMMANDS
  106.      -----------------
  107.      Following are the commands that are built into PREPS, along with their
  108.      descriptions. (Some commands are not supported on some printers.)
  109.  
  110.      Command           Description
  111.  
  112.      1/6               Sets paper feed amount to 1/6 inch
  113.      1/8[-]            Sets paper feed amount to 1/8 inch
  114.      7/72[-]           Sets paper feed amount to 7/72 inch
  115.      BackSpace         Prints buffer and backspaces one space
  116.      Bell              Sounds buzzer
  117.      Black             Selects Black color (color printers only)
  118.      Blue[-]           Selects Blue color (color printers only)
  119.      BoldPS[-]         Selects Bold PS font
  120.  
  121.  
  122.  
  123.      PREPS V1.11 Copyright (c) 1992-1993 Copy Con Incorporated       Page 3
  124.  
  125.  
  126.      BUILT-IN COMMANDS (continued)
  127.      -----------------------------
  128.  
  129.      Command           Description
  130.  
  131.      Cancel            Clears all data in the buffer
  132.      Center[-]         Enables automatic centering of print lines
  133.      Compressed[-]     Sets printing to 17 CPI
  134.      Courier[-]        Selects Courier font
  135.      CR                Prints buffer and starts next line at left margin
  136.      Delete            Deletes the last character stored in the buffer
  137.      Denmark[-]        Selects Denmark character set
  138.      DeSelect[-]       Disables printer from receiving data
  139.      Double[-]         Sets double printing
  140.      Draft[-]          Selects Draft font
  141.      Elite             Sets printing to 12 CPI
  142.      Emphasized[-]     Sets printing to twice the original dot density
  143.      England[-]        Selects England character set
  144.      Escape            Sends the escape ($1B) code
  145.      FF                Prints buffer and feeds paper to next TOF position
  146.      Flush             Prints all data in buffer
  147.      France[-]         Selects France character set
  148.      Germany[-]        Selects Germany character set
  149.      Graphic           Selects Standard Graphic character set
  150.      Green[-]          Selects Green color (color printers only)
  151.      HalfLF[-]         Prints buffer and feeds paper 1/12 inch
  152.      HalfSpeed[-]      Sets printing to half speed
  153.      IBM1              Selects IBM 1 character set
  154.      IBM2              Selects IBM 2 character set
  155.      Incremental[-]    Prints each character after it is entered
  156.      International[-]  Defines undefined codes as international characters
  157.      Italic[-]         Selects Italic font
  158.      Italy[-]          Selects Italy character set
  159.      Japan[-]          Selects Japan character set
  160.      Justification[-]  Sets automatic justification of print lines
  161.      LatinAmerica[-]   Selects Latin America character set
  162.      LeftAlign         Sets print alignment at the left margin
  163.      Legal[-]          Selects Legal character set
  164.      LF[-]             Prints buffer and executes a single line feed
  165.      Micron            Sets printing to 15 CPI
  166.      NLQ[-]            Selects NLQ font
  167.      Norway[-]         Selects Norway character set
  168.      Null              Sends the null ($00) code
  169.      Orange[-]         Selects Orange color (color printers only)
  170.      PaperOut[-]       Enables paper out detector
  171.      Pica              Sets printing to 10 CPI
  172.      Prestige[-]       Selects Prestige font
  173.      Proportional[-]   Sets proportional spacing between characters
  174.      Red[-]            Selects Red color (color printers only)
  175.      Reset             Resets printer to initial state
  176.      RightAlign[-]     Sets print alignment at the right margin
  177.      Roman[-]          Selects Roman font
  178.      SansSerif[-]      Selects Sans Serif font
  179.      Script[-]         Selects Script font
  180.  
  181.  
  182.  
  183.      PREPS V1.11 Copyright (c) 1992-1993 Copy Con Incorporated       Page 4
  184.  
  185.  
  186.      BUILT-IN COMMANDS (continued)
  187.      -----------------------------
  188.  
  189.      Command           Description
  190.  
  191.      Select[-]         Enables printer to receive data
  192.      SheetFeed[-]      Enables the sheet feeder (if installed)
  193.      Single[-]         Sets single direction printing mode
  194.      Single1[-]        Sets single direction printing mode for one line
  195.      Spain1[-]         Selects Spain 1 character set
  196.      Spain2[-]         Selects Spain 2 character set
  197.      SubScript[-]      Selects subscript font
  198.      SuperScript[-]    Selects superscript font
  199.      Sweden[-]         Selects Sweden character set
  200.      Tab               Sends the horizontal tab ($09) code
  201.      Tall[-]           Sets double height character printing
  202.      Underline[-]      Sets continuous underlining of characters
  203.      USA               Selects USA character set
  204.      Violet[-]         Selects Violet color (color printers only)
  205.      VTab              Sends the vertical tab ($11) code
  206.      Wide[-]           Sets double width character printing
  207.      Wide1[-]          Sets double width character printing for one line
  208.      Yellow[-]         Selects Yellow color (color printers only)
  209.  
  210.  
  211.      CREATING NEW COMMANDS
  212.      ---------------------
  213.      If you want to send a code that is not already built-in, you can
  214.      create your own using binary, octal, decimal, hex, and text codes.
  215.      Binary codes must be preceded with the % symbol, octal with the &
  216.      symbol, + for decimal, $ for hex, and ' for text; for example,
  217.  
  218.         PREPS $1b 'P +1
  219.  
  220.      sends 1B in hex, 'P' in text, and 1 in ASCII decimal. To send an
  221.      entire text string, you still use the ' symbol, but you must also
  222.      enclose the entire string in quotes; for example,
  223.  
  224.         PREPS bold "'one two three" bold-
  225.  
  226.      prints "one two three" (without the quotes) in bold.
  227.  
  228.      Strings of codes can be assigned a command name and stored in a
  229.      separate data file called PREPS.DAT, which must be kept in the same
  230.      directory as PREPS.EXE. PREPS.DAT will be searched first in case you
  231.      wish to redefine the internal commands. The format of each line of the
  232.      data file is as follows:
  233.  
  234.         command_name code [code]... [ - code [code]... ]
  235.  
  236.  
  237.  
  238.      PREPS V1.11 Copyright (c) 1992-1993 Copy Con Incorporated       Page 5
  239.  
  240.  
  241.      CREATING NEW COMMANDS (continued)
  242.      ---------------------------------
  243.      The command name must be left-justified (no left margin), and it
  244.      cannot contain any spaces. Following the name are the codes that
  245.      enable the command. If the command can be disabled, the enabling codes
  246.      are followed by a minus sign and the codes that disable the command.
  247.      The name, codes, and minus sign must be separated by spaces and/or
  248.      tabs. There is no limit to the number of commands, but there can only
  249.      be one command per line.
  250.  
  251.      For example, let's create a new command called SkipPerf. The codes to
  252.      skip six lines at the bottom of each page are $1b, 'N, and +6. Using
  253.      an ASCII text editor, create PREPS.DAT with the first line reading:
  254.  
  255.         SkipPerf $1b 'N +6
  256.  
  257.      Now, if you type "PREPS skip", $1b, 'N, and +6 will be sent. What if
  258.      you want to disable perforation skip? First, edit PREPS.DAT to read:
  259.  
  260.         SkipPerf $1b 'N +6 - $1b 'O
  261.  
  262.      Now, if you type "PREPS skip-", $1b and 'O will be sent, which are the
  263.      codes to disable perforation skip.
  264.  
  265.  
  266.      EXAMPLES
  267.      --------
  268.      PREPS
  269.        will show a help screen and a list of built-in commands.
  270.  
  271.      PREPS ff
  272.        sends a formfeed to the printer attached to LPT1.
  273.  
  274.      PREPS /lpt2 ff
  275.        sends a formfeed to the printer attached to LPT2.
  276.  
  277.      PREPS bold under- italic-
  278.        enables bold text, and disables underlining and italics.
  279.  
  280.      PREPS esc 'W +1
  281.        sends the escape code, the letter W, and ASCII character 1.
  282.  
  283.      PREPS "'line one" cr lf wide "'line two" wide- cr lf
  284.        prints two lines, the second one being of double width.
  285.  
  286.      PREPS /hi.txt tall wide bold under "'hello there" cr lf
  287.        sends "hello there" in tall, wide, bold, underlined characters, to
  288.        the file HI.TXT, which can be printed by typing "copy hi.txt LPTx",
  289.        where x is the number of the printer port to be used.
  290.  
  291.  
  292.  
  293.      PREPS V1.11 Copyright (c) 1992-1993 Copy Con Incorporated       Page 6
  294.  
  295.  
  296.      SUPPORT
  297.      -------
  298.      If you have questions, comments, suggestions, bug reports, et cetera,
  299.      feel free to contact me by one of the following methods:
  300.  
  301.      1: By modem at The Programmer's Corner (301-596-7692 or 410-995-6873).
  302.         Send a message to RD Thomas in the General conference, and check
  303.         back in a couple of days for a reply.
  304.  
  305.      2: By modem in the RIME Shareware conference (RD Thomas ->1520). If
  306.         you do not recieve a reply within a week, it is because there are
  307.         still some kinks to be worked out at this node; try contacting me
  308.         via methods 1 or 3.
  309.  
  310.      3: By US Mail at the address given on the first page. If you would
  311.         like a reply, please include a self-addressed, stamped envelope.
  312.  
  313.      Looking forward to hearing from you.
  314.  
  315.  
  316.      This document can be printed by typing "copy preps.doc LPTx" at the
  317.      DOS prompt, where x is the number of the printer port to be used.
  318.